home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / mbank213.zip / MAXIBANK.DOC < prev    next >
Text File  |  1992-05-17  |  11KB  |  259 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                 MAXIBANK v2.13
  12.  
  13.                                 (c)1992 RAFware
  14.  
  15.                               (1:xxx/xxx)@Fidonet.org
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25. -------------------------------------------------------------------------------
  26. DISCLAIMER
  27. -------------------------------------------------------------------------------
  28.  
  29. I don't claim that MaxiBank is  good  for  anything -- if  you think  it  is,
  30. great, but it's up to  you  to  decide.  If  MaxiBank  doesn't  work:  tough.
  31. If  you  lose  a  million because MaxiBank messes up, it's you that's out the
  32. million,  not me. If you don't like this  disclaimer:  tough   I  reserve the
  33. right to  do  the  absolute  minumum  provided  by  law,  up to and including
  34. nothing.
  35.  
  36. This is basically the same disclaimer that comes with  all software packages,
  37. but this is in plain English and other ones are in legalese.
  38.  
  39. -------------------------------------------------------------------------------
  40. WHAT IT DOES
  41. -------------------------------------------------------------------------------
  42.  
  43. Have your users ever complained that they don't have  enough  time?  Do  they
  44. ask for more time to download a massive file, or to  play  online  games?  If
  45. so, then your users will appreciate a 'time bank'.  What this  door  does  is
  46. allows a user to deposit time for later use.                        
  47.  
  48. -------------------------------------------------------------------------------
  49. FEATURES
  50. -------------------------------------------------------------------------------
  51.  
  52. - Allows deposits and withdrawls
  53. - Can give interest to users based on amount of time in their account
  54. - Allows a maximum amount of time to be withdrawn
  55. - Can be set to disallow withdrawls during certain hours
  56. - Built in 'Bank Manager' function
  57. - Allows 'Bonus' time for new accounts
  58. - Allows user to transfer time to any other users' account.
  59. - Will not let users overrun system events  
  60. - Totally configurable, and easy to set up
  61. - Built in help screen
  62. - ANSI graphics available
  63. - Uses FOSSIL driver
  64. - ByteBank feature - user can reduce/erase their daily download amount.
  65.  
  66. -------------------------------------------------------------------------------
  67. HOW IT WORKS
  68. -------------------------------------------------------------------------------
  69.  
  70. The user loads  the bank door  and  deposits  some  of his online time.  This
  71. time is then stored in the bank account for  later use and is subtracted from
  72. his current online time.  The user may  then  call back at a later  date  and
  73. use  this  time  for  whatever  purposes he may have.  Essentially,  the user
  74. spends less time during one call, and more time during another call.
  75.  
  76. Also, the user has the ability to use the ByteBank.  Let's say the user down-
  77. loaded a 200K file, and has a 500K download limit.  Now he wants to  download
  78. a 400K file, but alas - he can't!  This is where the ByteBank comes  in.  All
  79. the user has to do is load MaxiBank and  choose  the  ByteBank  option.  Here
  80. the user can clear the amount of kilobytes he has used today by paying it off
  81. with his time.  MaxiBank calculates the  amount of time needed to pay off the
  82. bytes based  on the user's baud rate.  So, for  200K,  MaxiBank would ask the
  83. user to pay, let's say; 15 minutes (@ 2400 baud) to clear it.
  84.  
  85. -------------------------------------------------------------------------------
  86. REQUIREMENTS
  87. -------------------------------------------------------------------------------
  88.  
  89.  - Maximus CBCS
  90.  - MS-DOS v3.0 or higher
  91.  - a FOSSIL (for online use).
  92.  - 134,000 bytes of free RAM.
  93.  - and half a brain
  94.  
  95. Although I'm sure the first four items are obvious,  I've included them just
  96. incase you lack the fifth <grin>.
  97.  
  98. ------------------------------------------------------------------------------
  99. IMPLEMENTATION
  100. ------------------------------------------------------------------------------
  101.  
  102. Setting  up  MaxiBank  is  pretty  easy.  For starters, just copy BANKER.EXE, 
  103. MAXIBANK.EXE  and   MAXIBANK.CFG   into  either  your  Maximus  directory  or
  104. any  other  directory.  Your  next  step  is  to  configure  MaxiBank.   This
  105. is done by  editing the  MAXIBANK.CFG  file  (it  contains  comments, so each
  106. option should be self-explanatory).      
  107.  
  108. You can call up MaxiBank from your MENUS.CTL by adding:
  109.  
  110.     ReRead Xtern_Run C:\Max\MaxiBank.Exe <options>   Normal "$)Time Bank"
  111.  
  112. You can also call MaxiBank up from a BBS file like this:   
  113.  
  114.     [Xtern_Run]@C:\Max\MaxiBank.Exe <option>
  115.  
  116.                ^ Tells Maximus to re-read the LASTUSER.BBS upon reloading.
  117.  
  118. Note: This program will *NOT* work in an External Errorlevel Exit from
  119.       Maximus.
  120.  
  121. ------------------------------------------------------------------------------
  122. COMMAND LINE SWITCHES
  123. ------------------------------------------------------------------------------
  124.  
  125. MaxiBank supports the following switches, which will override  the  settings
  126. inside of MAXIBANK.CFG (all switches are optional; if you load MaxiBank with
  127. no arguments it will use the settings in the CFG file).
  128.  
  129. Usage:  MaxiBank <options>
  130.  
  131. Where <options> are:
  132.  
  133. /C<filename>       - name of configuration file to use              
  134. /T<#>              - Maximus task number to use                
  135. /P<#>              - COMM port to use (COM1 = 1, COM2 = 2, etc) 
  136. /E                 - starts MaxiBank up in LOCAL Bank Manager mode
  137. /L<filename>       - specify MaxiLog filename, overrides .CFG option
  138. /D#                - Deletes inactive accounts, # = days of inactivty
  139.                    - Reports deletions in MaxiLog, and returns to DOS
  140.                    - /L option must come before any /D# options.
  141.  
  142. For example, a multi-line system might look like:
  143.  
  144.    MaxiBank.Exe /Cc:\max\bank1.cfg /T1 /P2
  145.  
  146. ------------------------------------------------------------------------------
  147. BANKER.EXE
  148. ------------------------------------------------------------------------------
  149.  
  150. You MUST run BANKER.EXE after each caller so that  the TIME ONTODAY field in
  151. the USER.BBS is  adjusted  according  the  amount  of time that the user has
  152. deposited in his account.  If the user didn't deposit any time, then nothing
  153. will be changed.  This  is  done so that the user can't call back and exceed
  154. his daily accumulated time limit. I  prefer not  to fiddle  with  this while
  155. Maximus is active.  Max v1.02  did not allow  any changes to the TimeOnToday
  156. value and Max v2.00 has gone berserk internally  with regards to this value.
  157. Running Banker after every  logoff takes about 2 seconds if no  transactions
  158. have occured. Less time on speady drives. Much less than ScanBld etc...
  159.  
  160. BANKER supports the following options (if none are  specified,  then  Banker 
  161. will assume the default names, and will look in the current directory):
  162.  
  163. Usage:  Banker <datafile> <userfile> <logfile>
  164.  
  165. <datafile>         - the filename and the directory that your bank DAT
  166.                      file resides in    
  167.  
  168. <userfile>         - the filename and path of your Maximus USER.BBS file
  169.  
  170. <logfile>          - name of the logfile for BANKER to write to
  171.  
  172. Example: 
  173.  
  174.     Banker.Exe C:\Max\MaxiBank.DAT C:\Max\User.BBS C:\Max\Max.LOG
  175.  
  176.  
  177. ------------------------------------------------------------------------------
  178. USING MAXIBANK
  179. ------------------------------------------------------------------------------
  180.  
  181. When you first run MaxiBank, it will create it's data file and will award
  182. users that  open  a new account with the amount specified in the CFG file
  183. and deposit  it  into his account.  The  user  is then presented with the 
  184. following options, all of which are quite self-explanatory:
  185.  
  186.         D)eposit, W)ithdrawl, T)ransfer, B)yteBank and Q)uit ?
  187.  
  188. If there is an impending event, or if the user is  not  allowed  to  make
  189. withdrawls, then the W)ithdrawl option will  not be available.   Also, if
  190. the user has not downloaded any files, then the ByteBank  option will not
  191. be there either. Users can Transfer Time from their account  to any other
  192. users' account.
  193.  
  194. If the user does not make any  transactions,  then  no  account  will  be 
  195. created.  This is useful if you just want to use the manager fuction, but
  196. do not wish to have an account.
  197.  
  198. If your username matches that of the name specified for 'Bank Manager' in
  199. the CFG file then the following options will  be  available  through  the 
  200. 'E)dit' command which will also appear at the Main Menu:
  201.  
  202.    N)ext, L)ist, P)revious, F)ind, J)ump, S)ort, E)dit, Q)uit ?
  203.  
  204. The user records will be displayed in the following form:
  205.  
  206. Account # 2.   First Last                       21 Jan 91 00:00:00    30
  207.  
  208.           ^ Record#   ^ User Name           Last visit ^      Minutes ^
  209.                                                 (Date)         (Time)
  210.  
  211. By choosing the 'E)dit' command from the Edit Menu, the following commands
  212. will be available to you:
  213.  
  214.    N)ame, D)ate, B)alance, H)ide, M)ark, P)urge, A)dd, L)evels, Q)uit ?
  215.  
  216. All  are self-explanatory, except for the 'M)ark' command.  This  allows you
  217. to tag  user names for  deletion.  Note,  you  will  not  be  able  to  edit 
  218. anything in account 0 except for 'time',  the  total number of transactions.
  219. 'P)urge' allows you to 'M)ark'  accounts by number of days of inactivty. The
  220. S)ort command  allows you to selectively sort the data file by Name, Date or
  221. time in users' account.  Prefix your sort selection with a '-' for a reverse
  222. direction sort. The H)ide command makes this account perminent. All attempts
  223. to M)ark or P)urge will be ignored.  Un H)ide if you want to M)ark.  L)evels
  224. will display the privilege level of the current user and the account limits.
  225. If you are  looking  at the very  first record, the MaxiBank logo, then this
  226. option will list all privileges and the limits. These limit values cannot be
  227. changed while in editor mode, you  must edit Maxibank.Cfg,  this option only
  228. displays the values found in MaxiBank.Cfg.
  229.  
  230. ------------------------------------------------------------------------------
  231. SAMPLE BBS FILE
  232. ------------------------------------------------------------------------------
  233.  
  234. On my system, I load MaxiBank through a BBS file.  This is what my BANK.BBS
  235. file looks like:
  236.  
  237. [cls][ckoff][moreoff]
  238. [dbelow][white]Sorry, you must be registered to use this function. [quit]
  239. [gray][xtern_run]@c:\max\maxibank.exe /T%k /P%P
  240. [white][enter][cls][quit]
  241.  
  242. As you can see, I restrict the use of MaxiBank to users with Normal access
  243. or higher.  Note the '@' after the [xtern_run]  token;  this tells Maximus
  244. to re-read the LASTUSER.BBS file.
  245.  
  246. ------------------------------------------------------------------------------
  247. SUPPORT
  248. ------------------------------------------------------------------------------
  249.  
  250. You can reach the author of MaxiBank, Rodney Fraser, at 1:153/715 (FidoNet).
  251.  
  252. You can always file request the latest version of MaxiBank from the following
  253. address:
  254.  
  255.             1:xxx/xxx, 2400/MNP
  256.  
  257. Enjoy!
  258.  
  259.